home *** CD-ROM | disk | FTP | other *** search
/ X User Tools / X User Tools (O'Reilly and Associates)(1994).ISO / sun4c / archive / tcltk.z / tcltk / man / cat3 / SetGrid.3 < prev    next >
Text File  |  1994-09-20  |  3KB  |  133 lines
  1.  
  2.  
  3.  
  4. Tk_SetGrid(3)         Tk Library Procedures
  5.  
  6.  
  7.  
  8. _________________________________________________________________
  9.  
  10. NAME
  11.      Tk_SetGrid - control the grid for interactive resizing
  12.  
  13. SYNOPSIS
  14.      #include <tk.h>
  15.  
  16.      Tk_SetGrid(_t_k_w_i_n, _r_e_q_W_i_d_t_h, _r_e_q_H_e_i_g_h_t, _w_i_d_t_h_I_n_c, _h_e_i_g_h_t_I_n_c)
  17.  
  18. ARGUMENTS
  19.      Tk_Window   _t_k_w_i_n       (in)      Token for window.
  20.  
  21.      int         _r_e_q_W_i_d_t_h    (in)      Width in grid  units  that
  22.                                        corresponds  to  the pixel
  23.                                        dimension    _t_k_w_i_n     has
  24.                                        requested              via
  25.                                        Tk_GeometryRequest.
  26.  
  27.      int         _r_e_q_H_e_i_g_h_t   (in)      Height in grid units  that
  28.                                        corresponds  to  the pixel
  29.                                        dimension    _t_k_w_i_n     has
  30.                                        requested              via
  31.                                        Tk_GeometryRequest.
  32.  
  33.      int         _w_i_d_t_h_I_n_c    (in)      Width of one grid unit, in
  34.                                        pixels.
  35.  
  36.      int         _h_e_i_g_h_t_I_n_c   (in)      Height of one  grid  unit,
  37.                                        in pixels.
  38. _________________________________________________________________
  39.  
  40.  
  41. DESCRIPTION
  42.      Tk_SetGrid is typically invoked by a widget when its setGrid
  43.      option  is  true.  This procedure allows a widget to control
  44.      interactive resizing of its top-level  window  so  that  the
  45.      space  allocated  to  the  widget  is  equal  to  the  space
  46.      requested by the widget using  Tk_GeometryRequest,  plus  or
  47.      minus  even multiples of _w_i_d_t_h_I_n_c and _h_e_i_g_h_t_I_n_c.  Tk_SetGrid
  48.      turns on gridded geometry management for the top-level  win-
  49.      dow  associated  with  _t_k_w_i_n,  and  records the relationship
  50.      between pixel sizes and grid sizes as defined  by  _r_e_q_W_i_d_t_h,
  51.      _r_e_q_H_e_i_g_h_t, _w_i_d_t_h_I_n_c, and _h_e_i_g_h_t_I_n_c.
  52.  
  53.      See the wm manual entry  for  complete  details  on  gridded
  54.      geometry  management.  There is currently no way to turn off
  55.      gridded  geometry  management  using  a  C  procedure  call;
  56.      instead, invoke the ``wm grid'' command.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63. Tk                                                              1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. Tk_SetGrid(3)         Tk Library Procedures
  71.  
  72.  
  73.  
  74. KEYWORDS
  75.      grid, window, window manager
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129. Tk                                                              2
  130.  
  131.  
  132.  
  133.